Wide null-terminated strings

From Cppreference

C++ Standard Library
Language Utilities library Strings library Containers library Algorithms library Iterators library Numerics library Input/output library Localizations library Regular expressions library (C++11) Atomic operations library (C++11) Thread support library (C++11)
Strings library
Narrow character strings Wide character strings Classes basic_string char_traits
Wide null-terminated strings
Template:cpp/string/wide/sidebar content

A wide null-terminated string is a sequence of valid wide characters, ending with a null-character.

Contents 1 Wide character classification and manipulation 2 Conversions to numeric formats 3 Wide string operations 4 Wide character array operations 5 Multibyte/wide character conversions 6 Types 7 Macros

[edit] Wide character classification and manipulation

Defined in header <cwctype>
iswalnum	checks if a wide character is alphanumeric (function)
iswalpha	checks if a wide character is alphabetic (function)
iswlower	checks if a wide character is lowercase (function)
iswupper	checks if a wide character is an uppercase character (function)
iswdigit	checks if a wide character is a digit (function)
iswxdigit	checks if a character is a hexadecimal character (function)
iswcntrl	checks if a wide character is a control character (function)
iswgraph	checks if a wide character is a graphical character (function)
iswspace	checks if a wide character is a space character (function)
iswblank (C++11)	checks if a wide character is a blank character (function)
iswprint	checks if a wide character is a printing character (function)
iswpunct	checks if a wide character is a punctuation character (function)
wctype	looks up a character classification category in the current C locale (function)
iswctype	classifies a wide character according to the specified LC_CTYPE category (function)
towlower	converts a wide character to lowercase (function)
towupper	converts a wide character to uppercase (function)
wctrans	looks up a character mapping category in the current C locale (function)
towctrans	performs character mapping according to the specified LC_CTYPE mapping category (function)

[edit] Conversions to numeric formats

Defined in header <cwchar>
wcstof wcstod wcstold	converts a wide character string to a floating point value (function)
wcstol wcstoll	converts a wide character string to an integer value (function)
wcstoul wcstoull	converts a wide character string to an unsigned integer value (function)

[edit] Wide string operations

Defined in header <cwchar>
wcslen	returns the length of a wide string (function)
wcscpy	copies one wide string to another (function)
wcsncpy	copies a certain amount of wide characters from one string to another (function)
wcscat	appends a copy of one wide string to another (function)
wcsncat	appends a certain amount of wide characters from one wide string to another (function)
wcscmp	lexicographically compares two wide strings, locale-independent (function)
wcscoll	lexicographically compares two wide strings, locale-dependent (function)
wcsncmp	compares a certain amount of characters from two wide strings (function)
wcsxfrm	transform a wide string so that wcscmp would produce the same result as wcscoll (function)
wcschr	finds the first occurrence of a wide character in a wide string (function)
wcsrchr	finds the last occurrence of a wide character in a wide string (function)
wcspbrk	finds the first occurrence of any wide character from another wide string (function)
wcsspn	returns the length of the maximum prefix that consists of only the characters found in another wide string (function)
wcscspn	returns the length of the maximum prefix that consists of only the characters not found in another wide string (function)
wcsstr	finds the first occurrence of a wide string within another wide string (function)
wcstok	finds the next token in a wide character string (function)

[edit] Wide character array operations

Defined in header <cwchar>
wmemcpy	copies a certain amount of wide characters between two non-overlapping arrays (function)
wmemmove	copies a certain amount of wide characters between two, possibly overlapping, arrays (function)
wmemcmp	compares a certain amount of wide characters from two arrays (function)
wmemchr	finds the first occurrence of a wide character in a wide character array (function)
wmemset	copies the given wide character to every position in a wide character array (function)

[edit] Multibyte/wide character conversions

Defined in header <cstdlib>
mblen	returns the number of bytes in the next multibyte character (function)
mbtowc	converts the next multibyte character to wide character (function)
wctomb	converts a wide character to its multibyte representation (function)
mbstowcs	converts a narrow multibyte character string to wide character string (function)
wcstombs	converts a wide character string to narrow multibyte character string (function)
Defined in header <cwchar>
mbsinit	checks if the mbstate_t object represents initial shift state (function)
btowc	widens a single-byte narrow character to wide character, if possible (function)
wctob	narrows a wide character to a single-byte narrow character, if possible (function)
mbrlen	returns the number of bytes in the next multibyte character, given state (function)
mbrtowc	converts the next multibyte character to wide character, given state (function)
wcrtomb	converts a wide character to its multibyte representation, given state (function)
mbsrtowcs	converts a narrow multibyte character string to wide character string, given state (function)
wcsrtombs	converts a wide character string to narrow multibyte character string, given state (function)
Defined in header <cuchar>
mbrtoc16 (C++11)	generate the next 16-bit wide character from a narrow multibyte string (function)
c16rtombr (C++11)	convert a 16-bit wide character to narrow multibyte string (function)
mbrtoc32 (C++11)	generate the next 32-bit wide character from a narrow multibyte string (function)
c32rtombr (C++11)	convert a 32-bit wide character to narrow multibyte string (function)

[edit] Types

Defined in header <cwctype>
wctrans_t	scalar type that holds locale-specific character mapping
wctype_t	scalar type that holds locale-specific character classification
wint_t	integer type that can hold any valid wide character and at least one more value
Defined in header <cwchar>
mbstate_t	scalar type that holds the state information necessary to convert between sequences of multibyte and wide characters

[edit] Macros

Defined in header <climits>
MB_LEN_MAX	maximum number of bytes in a multibyte character (macro constant)
Defined in header <cstdlib>
MB_CUR_MAX	maximum number of bytes in a multibyte character in the current C locale (macro constant)
Defined in header <cwchar>
WEOF	a non-character value of type wint_t used to indicate errors (macro constant)
WCHAR_MIN	the smallest valid value of wchar_t (macro constant)
WCHAR_MAX	the largest valid value of wchar_t (macro constant)
Defined in header <cuchar>
__STDC_UTF_16__	indicates that UTF-16 encoding is used by mbrtoc16 and c16rtomb (macro constant)
__STDC_UTF_32__	indicates that UTF-32 encoding is used by mbrtoc32 and c32rtomb (macro constant)